---
title: "Deploy AionUi"
description: "AionUi: headless web AI agent workspace with document generation."
category: "AI/ML"
url: https://railway.com/deploy/aionui-1
---

# Deploy AionUi

AionUi: headless web AI agent workspace with document generation.

**[Deploy AionUi on Railway](https://railway.com/template/aionui-1)**

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

- **Creator:** wotonews
- **Category:** AI/ML

## Template content

### aionui

- **Image:** wotonews/aionui:v2.1.47-1

## Documentation

# Deploy and Host AionUi with Railway

AionUi is an AI agent workspace with a web UI: chat with AI agents, generate office documents (Word, Excel, PowerPoint, PDF, Mermaid diagrams), and run agent tasks — all from a headless server, no desktop app required.

## About Hosting AionUi

This template deploys AionUi's WebUI mode: the same server that powers the desktop app, the official no-Electron web runtime from the pinned upstream release, running headless with `HOME` on a persistent volume at `/data` — the SQLite database, configuration, generated documents, and logs all survive redeploys. Remote access is enabled in the image and Railway's injected port is honored.

On first boot AionUi generates a random admin password and **prints it in the deploy logs** — open the deployment logs, find the password line, sign in at the public domain, and change the password from the settings page. Everything else needs no configuration.

## Why Deploy AionUi on Railway?

- **One platform:** host the agent workspace next to your APIs and databases on a private network.
- **Always on:** agents keep working after you close the laptop; sessions persist on the volume.
- **Zero-config secrets:** no passwords ship with the template — the first-boot password is random and only lives in your logs.
- **Scale on demand:** the image recommends ~2 GB RAM for document generation; vertical scaling takes seconds.

## Common Use Cases

- Web-based AI chat workspace for a small team, reachable from anywhere.
- Automated document generation (reports, spreadsheets, slide decks) via agent tasks.
- A private, self-hosted alternative to hosted AI workspace products.
- Running Gemini/OpenAI/Antropic-powered agents against uploaded office files.

## Dependencies for AionUi Hosting

- Docker image: official [`aionui-web` `2.1.47`](https://github.com/iOfficeAI/AionUi/releases/tag/v2.1.47-final) release tarball (self-contained bun binary + aioncore), published as `wotonews/aionui:v2.1.47-1`
- Bun runtime, .NET officecli (ICU included), SQLite (embedded, volume-backed)
- Bring your own AI provider keys (Gemini, OpenAI, Anthropic, …) from the in-app settings

### Deployment Dependencies

- Source: https://github.com/iOfficeAI/AionUi (Apache-2.0)
- Docs: https://github.com/iOfficeAI/AionUi/blob/main/docs/guides/webui.md

## First Login

1. Deploy the template — no variables to fill in.
2. Generate a public domain on the service (if none was created).
3. Open the deployment logs and find the randomly generated initial password.
4. Sign in at `https://` and change the password in settings.
5. Add AI provider keys in the in-app settings.

## Environment Variables

None required. The image bakes `AIONUI_ALLOW_REMOTE=true`, `HOME=/data`, and honors the Railway-injected `PORT`. Optional overrides can be set as service variables (`AIONUI_PORT`, `AIONUI_HOST`).

## Local Setup

```bash
docker build -t wotonews/aionui:v2.1.47-1 .
docker run -d --name aionui -p 3000:3000 -v aionui-data:/data wotonews/aionui:v2.1.47-1
docker logs aionui   # find the initial admin password
```




## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/aionui-1