https://github.com/andresribeiro/ciara
Securely deploy any application on any server.
https://github.com/andresribeiro/ciara
caddy containers deploy deployment devops docker flatcar-linux self-hosted
Last synced: 2 days ago
JSON representation
Securely deploy any application on any server.
- Host: GitHub
- URL: https://github.com/andresribeiro/ciara
- Owner: andresribeiro
- License: mit
- Created: 2025-06-22T11:17:10.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-29T19:12:58.000Z (10 months ago)
- Last Synced: 2025-09-23T02:59:41.690Z (7 months ago)
- Topics: caddy, containers, deploy, deployment, devops, docker, flatcar-linux, self-hosted
- Language: TypeScript
- Homepage: https://ciara-deploy.dev
- Size: 169 KB
- Stars: 33
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ciara
Securely deploy any application on any server.
[](https://opensource.org/licenses/MIT)
[](https://github.com/andresribeiro/ciara-docs)
- 🗄️ VM OR Bare Metal
- 🗝️ Integrated Firewall
- 🔧 Automatic security system updates
- ⚙️ Zero-Config OS Ready
- ⏱️ Zero-Downtime Deployments
- 🔒 Automatic HTTPS support
- 🛠️ Simple config file
## Quickstart
```bash
npm install -g ciara-deploy
cd your-project
ciara init
ciara deploy
```
## Requirements
- Servers: Debian OS (fresh install recommended)
- Local machine: Bun runtime
## Configuration
All settings are managed in ciara.config.json:
```json
{
"appName": "my-website",
"servers": [
{
"ip": "127.0.0.1",
"port": 22
}
],
"ssh": {
"privateKeyPath": "/root/.ssh/id_rsa"
},
"proxy": {
"port": 3000
},
"healthcheck": {
"path": "/",
"interval": 5,
"timeout": 3,
"retries": 5
},
"firewall": {
"inbound": [
{
"port": 22,
"allow": "*",
"protocols": ["tcp"]
}
]
},
"updates": {
"reboots": {
"enabled": true,
"time": "03:00"
}
},
"builder": {
"host": "127.0.0.1"
}
}
```
That's it. Ciara takes care of all the rest. For further details and a complete guide, please refer to our official documentation: [Ciara Quickstart Guide](https://ciara-deploy.dev/quickstart.html).
## License
Distributed under the MIT License. See [LICENSE](LICENSE) for more information.