Using Volumes
Volumes allow you to store persistent data for services on Railway.
Creating A Volume
You can create a new volume through the Command Palette (⌘K
)
or by right-clicking the project canvas to bring up a menu:
When creating a volume, you will be prompted to select a service to connect the volume to:
You must configure the mount path of the volume in your service:
Using the Volume
The volume mount point you specify will be available in your service as a directory to which you can read/write. If you mount a volume to /foobar
, your application will be able to access it at the absolute path /foobar
.
Relative Paths
Nixpacks, the default buildpack used by Railway, puts your application files in an /app
folder at the root of the container. If your application writes to a directory at a relative path, and you need to persist that data on the volume, your mount path should include the app path.
For example, if your application writes data to ./data
, you should mount the volume to /app/data
.
Provided Variables
Attaching a Volume to a service will automatically make these environment variables available to the service at runtime:
RAILWAY_VOLUME_NAME
: Name of the volume (e.g.foobar
)RAILWAY_VOLUME_MOUNT_PATH
: Mount path of the volume (e.g./foobar
)
You do not need to define these variables on the service, they are automatically set by Railway at runtime.
Volume Availability
Volumes are mounted to your service's container when it is started, not during build time.
If you write data to a directory at build time, it will not persist on the volume, even if it writes to the directory to which you have mounted the volume.
Volumes are not mounted as overlays.
Permissions
Volumes are mounted as the root
user. If you run an image that uses a non-root user, you should set the following variable on your service:
RAILWAY_RUN_UID=0
Growing the Volume
Only available to Pro users and above.
To increase capacity in a volume, you can "grow" it from the volume settings.
- Click on the volume to open the settings
- Click
Grow
- Follow the prompts to grow the volume
Note: growing a volume requires a restart of the attached service.
Backups
Services with volumes support manual and automated backups, backups are covered in the backups reference guide.
Edit this file on GitHub