Deploy and Host EasyNode on Railway

EasyNode is a multi-functional web terminal panel for managing Linux and Windows servers through WebSSH and WebSFTP. It includes SSH and SFTP access, jump server functionality, AI-assisted terminal conversations, batch command execution, script management, credential hosting, instance grouping, notifications, and customizable terminal themes.

About Hosting EasyNode

Hosting EasyNode on Railway involves deploying the chaoszhu/easynode:latest Docker image as a Railway service. The application exposes its web panel on HTTP port 8082, which can be connected to a Railway public domain for browser access. EasyNode stores its application database under /easynode/app/db, so a persistent Railway Volume is required at that path. The supplied configuration also defines a DEBUG environment variable with a default value of 0. EasyNode uses the deployed server as a relay for WebSSH and monitoring traffic, making the location and network characteristics of the Railway service relevant to remote-server connectivity. Because the panel manages server credentials and SSH access, appropriate access controls such as MFA and IP whitelisting are recommended.

Common Use Cases

Managing Linux and Windows servers through a browser-based WebSSH and WebSFTP panel
Executing commands, managing scripts, and organizing multiple server instances from a centralized interface
Providing a relay point for remote server access and monitoring workflows

Dependencies for EasyNode Hosting

chaoszhu/easynode:latest Docker image
Persistent Railway Volume mounted at /easynode/app/db

Deployment Dependencies

Implementation Details

Docker

Deploy the following Docker image:

chaoszhu/easynode:latest

Railway can deploy the prebuilt Docker image directly, so no custom Dockerfile or build command is required by the supplied template.

Public Networking

EasyNode exposes its web panel on port 8082:

Protocol	Proxy Type	Target Port	Purpose
HTTP	HTTP Proxy	8082	EasyNode web panel

After deployment, go to Settings → Networking and generate a Railway domain for port 8082. Railway provides HTTPS access through the generated domain.

Because EasyNode provides an administrative server-management panel, avoid exposing it publicly without appropriate access controls. The supplied documentation recommends security measures such as MFA and IP whitelisting.

Environment Variables

Variable	Required	Description
`DEBUG`	No	Debug configuration. The supplied template sets the default value to `0`.

Raw Editor:

DEBUG=0

No other runtime environment variables are documented in the supplied template.

Persistent Storage

Persistent storage is required for EasyNode.

To add the volume:

Open the EasyNode service in Railway.
Go to Settings.
Open Volumes.
Add a volume.
Set the mount path to:

/easynode/app/db

The volume preserves EasyNode's application database and associated data across service restarts and redeployments.

Database

No separate database service is documented.

EasyNode stores its application database in the persistent directory:

/easynode/app/db

Build & Start

No custom build or start commands are required.

Railway deploys the prebuilt Docker image:

chaoszhu/easynode:latest

Accessing the Application

Create a new Railway project.
Add a service using the chaoszhu/easynode:latest Docker image.
Configure HTTP port 8082.
Add a Railway Volume mounted at /easynode/app/db.
Set DEBUG=0.
Deploy the service.
Open the Deployment Logs for the EasyNode service.
Look for the initial username and password generated during deployment.
Open Settings → Networking and generate a Railway domain for port 8082.
Open the generated HTTPS URL.
Log in using the username and password shown in the deployment logs.
Change the password after your first login.

First login: EasyNode does not use the old admin/admin default credentials. Check the Railway Deployment Logs after deployment to obtain the initial username and password. Use these credentials for your first login and change the password immediately afterward.

For additional security, enable MFA and configure IP whitelisting where appropriate.

EasyNode's WebSSH and monitoring functionality uses the deployed server as a relay, so consider the Railway deployment region and its network latency relative to the servers you intend to manage.

The project is licensed under the Business Source License 1.1. Refer to the project's licensing terms for applicable personal, educational, research, evaluation, testing, and commercial-use conditions.

Why Deploy EasyNode on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying EasyNode on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.