---
title: "Deploy Gianki Server"
description: "Run Gianki Team Chat on railway."
category: "Other"
url: https://railway.com/deploy/gianki-server
---

# Deploy Gianki Server

Run Gianki Team Chat on railway.

**[Deploy Gianki Server on Railway](https://railway.com/template/gianki-server)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/gianki-server/manifest.json

- **Creator:** Bill ODonnell's Projects
- **Category:** Other

## Template content

### gianki-server

- **Image:** ghcr.io/agentbillo/gianki-server:latest
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host Gianki Server on Railway

  Gianki is private team chat on a server of your own: channels, direct messages, threads, reactions, file sharing and search, with native apps for Mac, iPhone, iPad and Android and a web app. One deployment serves one team, and its messages stay in that deployment's volume and nowhere else.

## About Hosting Gianki Server

  Gianki Server is a single container with a single volume. The server holds accounts and settings in SQLite and messages in files beside it, all in the volume
  at `/data`, so there is no separate database or cache to run. Railway provides the HTTPS address the apps connect to. The first start creates your team and
  its first administrator; after that you invite people from the browser-based admin console. Hosting it means keeping the volume large enough for your team's
  uploads, using the volume's backups, and deploying a newer image when one is published. A redeployment is a short interruption, and the apps reconnect on
  their own.

## Common Use Cases

  - A company or team that wants its chat on infrastructure it controls
  - A community, club or project that wants its own chat space, with sign-up by invitation or registration code
  - Trying Gianki with a few people before running it on a machine of your own

## Dependencies for Gianki Server Hosting

  - A Railway volume mounted at `/data` (included in this template)
  - The Gianki apps, or the web app at `/web/` on your domain, for the people who will use it

### Implementation Details

  - Gianki apps and server documentation: https://gianki.com
  - Running the server in a container: https://gianki.com/server.html#docker
  - Container image: `ghcr.io/agentbillo/gianki-server`

  After deploying:

  1. Open the service's public domain and sign in as `admin`. The password was generated for you: it is the `GIANKI_ADMIN_PASSWORD` variable on the service's
  Variables tab.
  2. Open the admin console at `/admin` to invite people or create a registration code.
  3. In the apps, enter your domain as the server address.

  Variables:

  - GIANKI_ADMIN_PASSWORD: the first administrator's password. It is used once, when the team is created; changing it afterwards changes nothing.
  - GIANKI_TEAM_NAME: optional. Your team's name, which can be changed later in the console.
  - RAILWAY_DEPLOYMENT_DRAINING_SECONDS: leave at 45. It gives the server time to write its last messages to disk before a redeployment stops it.
  - PORT: leave at 8080.
  - With a custom domain, add `GIANKI_PUBLIC_ORIGIN=https://chat.example.com` so that invitation and password-reset links use it.

  Storage: the volume's size depends on your plan (0.5 GB on a trial, 5 GB on Hobby, 50 GB on Pro) and can be enlarged on paid plans. Uploads are what fill it.
  The server keeps 128 MB free and refuses new messages and uploads when less is left.

  Make a second administrator early, from the console's Users page: another administrator is the only way to reset an administrator's forgotten password.

## Why Deploy Gianki Server 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 Gianki Server 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.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/gianki-server
