---
title: The Basics
description: Learn about the core concepts of Railway.
---
This document outlines the core concepts of Railway, providing foundational knowledge of the basic building blocks you'll work with in the platform.

## In a nutshell

- **[Dashboard](#dashboard--projects)** - Main entrypoint for all projects under your account.
- **[Project](#project--project-canvas)** - A collection of services under the same network.
  - **[Project Settings](#project-settings)** - Contains all project-level settings.
- **[Service](#services)** - A target for a deployment source (e.g. Web Application).
  - **[Service Variables](#service-variables)** - A collection of configurations and secrets.
  - **[Backups](#backups)** - A collection of backups for a service.
  - **[Service Metrics](#service-metrics)** - Rundown of metrics for a service.
  - **[Service Settings](#service-settings)** - Contains all service-level settings.
- **[Deployment](#deployments)** - Built and deliverable unit of a service.
- **[Volumes](#volumes)** - Persistent storage solution for services.
  - **[Volume Metrics](#volume-metrics)** - Rundown of metrics for volumes (e.g. disk usage over time).
  - **[Volume Settings](#volume-settings)** - Contains all volume-level settings.

## Dashboard / projects

Your main entrypoint to Railway where all your [projects](/overview/the-basics#project--project-canvas) are shown in the order they were last opened.

Projects contain your [services](/overview/the-basics#services) and [environments](/environments).

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785111/docs/the-basics/dashboard_ycmxnk.png"
alt="Screenshot of the Railway dashboard"
layout="responsive"
width={1305} height={735} quality={100} />

## Project / project canvas

A project represents a capsule for composing infrastructure in Railway. You can think of a project as an application stack, a service group, or even a collection of service groups.

Services within a project are automatically joined to a [private network](/networking/private-networking) scoped to that project.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785173/docs/the-basics/project_canvas_dxpzxe.png"
alt="Screenshot of the project canvas"
layout="responsive"
width={1365} height={765} quality={100} />

### Project settings

This page contains all the project level settings.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785164/docs/the-basics/project_settings_ghwzih.png"
alt="Screenshot of the project settings page"
layout="responsive"
width={1365} height={765} quality={100} />

Some of the most commonly used project settings are -

- [Transfer Project](/projects/workspaces#transferring-projects) - Transfer your project between workspaces.

- [Environments](/environments) - Manage various settings regarding environments.

- [Members](/projects/project-members) - Add or remove members to collaborate on your project.

- Danger - Remove individual [services](/overview/the-basics#services) or delete the entire project.

## Services

A Railway service is a deployment target for your deployment source. Deployment sources can be [code repositories](https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories) or [Docker Images](https://docs.docker.com/guides/docker-concepts/the-basics/what-is-an-image/). Once you create a service and choose a source, Railway will analyze the source, build a Docker image (if the source is a code repository), and deploy it to the service.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785212/docs/the-basics/services_zuyl56.png"
alt="Screenshot of the project canvas with services highlighted"
layout="responsive"
width={1365} height={765} quality={100} />

Out of the box, your service is deployed with a set of default configurations which can be overridden as needed.

### Service variables

Service [Variables](/variables) provide a powerful way to manage configuration and secrets across services in Railway.

You can configure variables scoped to services. These variables are specific to each service and are not shared across the project by default.

If you want to access variables from this service in another service within the same project, you need to utilize a [Reference Variable](/variables/reference#reference-variables).

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785219/docs/the-basics/service_variables_galkry.png"
alt="Screenshot of the service variables tab"
layout="responsive"
width={1365} height={765} quality={100} />

### Backups

If your service has a [volume](/overview/the-basics#volumes) attached, this is where you can manage backups.

Backups are incremental and Copy-on-Write, we only charge for the data exclusive to them, that aren't from other snapshots or the volume itself.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785142/docs/the-basics/backups_fdx09o.png"
alt="Screenshot of the service backups tab"
layout="responsive"
width={1365} height={765} quality={100} />

From here you can perform the following actions -

- Create a backup - Manually create a backup of the volume with a press of a button.

- Delete a backup - Remove a backup from the list via the backup's 3-dot menu.

- Lock a backup - Prevent a backup from being deleted via the backup's 3-dot menu.

- [Restore a backup](/volumes/backups#how-to-restore-a-backup) - Click the `Restore` button on the backup.

- Modify the backup schedule - Click the `Edit schedule` button on the header to make changes to the schedule.

### Service metrics

Service [Metrics](/observability/metrics) provide an essential overview of CPU, memory, and network usage for a given service.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785153/docs/the-basics/service_metrics_dcbfms.png"
alt="Screenshot of the service metrics tab"
layout="responsive"
width={1365} height={770} quality={100} />

### Service settings

This tab contains all the service level settings.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785132/docs/the-basics/service_settings_lnyql0.png"
alt="Screenshot of the service settings tab"
layout="responsive"
width={1365} height={765} quality={100} />

Some of the most commonly used service settings are -

- [Source](/services#service-source) - Here you can configure the deployment source, which can be either a GitHub repository with a specific branch or an image with optional credentials.

- [Networking](/networking/public-networking#railway-provided-domain) - Generate a Railway-provided domain or add your own custom one.

- Custom Build Command - Here you can configure a custom build command if you need to overwrite the default.

- Custom Start Command - Here, you can configure a custom start command if you need to overwrite the default.

## Deployments

[Deployments](/deployments) involve building and delivering your [Service](/overview/the-basics#services).

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785123/docs/the-basics/deployment_l0trj8.png"
alt="Screenshot of a service open with a deployment highlighted"
layout="responsive"
width={1365} height={790} quality={100} />

## Volumes

[Volumes](/volumes) are a feature that allows services on Railway to [maintain persistent data](/volumes).

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785187/docs/the-basics/volumes_yom2km.png"
alt="Screenshot of the project canvas with a volume highlighted"
layout="responsive"
width={1365} height={765} quality={100} />

### Volume metrics

Volume Metrics show the amount of data stored in the volume and its maximum capacity.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785205/docs/the-basics/volume_metrics_thv60n.png"
alt="Screenshot of the volume metrics tab"
layout="responsive"
width={1365} height={826} quality={100} />

### Volume settings

This tab contains all the volume centric settings.

<Image src="https://res.cloudinary.com/railway/image/upload/v1737785195/docs/the-basics/volume_settings_kirpdn.png"
alt="Screenshot of the volume settings tab"
layout="responsive"
width={1365} height={826} quality={100} />

Some of the most commonly used volume settings are -

- Mount path - The absolute path where the volume will be mounted within the deployed service.

- Volume Size - Displays the current volume capacity and offers the option to expand it if your plan permits.

- Wipe Volume - This action wipes all data in the volume and then redeploys the connected service.

## What next?

If you've read enough for now and are ready to get started, check out either of these two resources next -

- [Quick Start guide](/quick-start) to deploy a To Do app from a [template](/templates).

- [Guides section](/overview/the-basics) to dive into how things work.

If you want to go deeper, click the Next button below to head to the next section - [Advanced Concepts](/overview/advanced-concepts).