Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ozgrozer/jaydon
Nginx control panel
https://github.com/ozgrozer/jaydon
control-panel nginx
Last synced: 9 days ago
JSON representation
Nginx control panel
- Host: GitHub
- URL: https://github.com/ozgrozer/jaydon
- Owner: ozgrozer
- License: mit
- Created: 2019-09-07T20:22:13.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-03T00:05:26.000Z (3 months ago)
- Last Synced: 2024-12-29T13:45:15.522Z (12 days ago)
- Topics: control-panel, nginx
- Language: JavaScript
- Homepage:
- Size: 786 KB
- Stars: 19
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# jaydon
[](https://github.com/ozgrozer/jaydon/tags)
[](https://github.com/ozgrozer/jaydon/blob/master/license)
Nginx Control Panel
> This is an experimental control panel written for a niche reason. Use at your own risk.
## Quick Installation
Ubuntu v24
```
curl -L https://raw.githubusercontent.com/ozgrozer/jaydon/master/install24.sh | bash
```
Ubuntu v22
```
curl -L https://raw.githubusercontent.com/ozgrozer/jaydon/master/install22.sh | bash
```
## Before Installation
> Unlike other control panels with Jaydon you control the versions of your softwares such as Nginx, Node.js etc.
Before you install Jaydon you need:
- [MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/)
- [Certbot](https://certbot.eff.org/lets-encrypt/ubuntubionic-nginx)
- [Nginx](https://www.nginx.com/resources/wiki/start/topics/tutorials/install/)
- [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- [Node.js](https://nodejs.org/en/download/package-manager/) & [NPM](https://www.npmjs.com/get-npm)
- [Yarn](https://www.npmjs.com/package/yarn)
- [PM2](https://www.npmjs.com/package/pm2)
Ubuntu v24
```
# Install essential tools
sudo apt-get update
sudo apt-get install build-essential -y
# Install MongoDB
sudo apt-get install gnupg curl -y
curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
sudo apt update
sudo apt install mongodb-org -y
sudo systemctl start mongod
sudo systemctl enable mongod
# Install Certbot
sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
# Install Nginx
sudo apt install nginx -y
# Install Git
sudo apt install git -y
# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y
# Install Yarn
sudo npm i -g yarn
# Install PM2
sudo npm i -g pm2
```
Ubuntu v22
```
# Install essential tools
sudo apt-get update
sudo apt-get install build-essential -y
# Install MongoDB
curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg arch=amd64,arm64] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
sudo apt update
sudo apt install mongodb-org -y
sudo systemctl start mongod
sudo systemctl enable mongod
# Install Certbot
sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot -y
sudo ln -s /snap/bin/certbot /usr/bin/certbot
# Install Nginx
sudo apt install nginx -y
# Install Git
sudo apt install git -y
# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y
# Install Yarn
sudo npm i -g yarn
# Install PM2
sudo npm i -g pm2
```
## Installation
If you have all the dependencies above now you can install Jaydon.
```
# Clone Git repository
git clone https://github.com/ozgrozer/jaydon.git && cd jaydon
# Install dependencies
yarn install
# Build React app
yarn build
# Create necessary database tables
yarn run first-run
# Start server with PM2
pm2 start ./src/backend/server.js --name jaydon
pm2 startup
pm2 save
# Open your browser and go to
http://your-ip:1148
```
## Update
Make sure update.sh is executable.
```
chmod +x update.sh
```
And just run it.
```
./update.sh
```
## API
Jaydon API built on [REST](https://en.wikipedia.org/wiki/Representational_state_transfer). It accepts requests as JSON and returns responses as JSON too.
Base URL.
```
http://your-ip:1148/api/v1
```
Example POST request.
```json
{
"meta": {
"apiKey": "YOUR_API_KEY",
"category": "domain|cronJob",
"event": "create|read|update|delete"
},
"data": {
}
}
```
"data" object.
```json
// create domain
"data": {
"domain": "example.com",
"gitSupport": true,
"sslSupport": true,
"nginxConf": "configuration"
}
// read a domain
"data": {
"id": "domain id"
}
// read domains
"data": {
}
// update domain
"data": {
"id": "domain id",
"domain": "example.com",
"gitSupport": false,
"sslSupport": false,
"nginxConf": "configuration"
}
// delete domain
"data": {
"id": "domain id"
}
---
// create cron job
"data": {
"command": "node script.js",
"schedule": "* * * * *"
}
// read a cron job
"data": {
"id": "cron job id"
}
// read cron jobs
"data": {
}
// update cron job
"data": {
"id": "cron job id",
"command": "node script.js",
"schedule": "* * * * *"
}
// delete cron job
"data": {
"id": "cron job id"
}
```
Example 1: Create a domain with cURL.
```bash
curl http://your-ip:1148/api/v1 \
-X POST \
-H "Content-Type: application/json" \
--data-binary @- << EOF
{
"meta": { "apiKey": "YOUR_API_KEY", "category": "domain", "event": "create" },
"data": { "domain": "test.com", "gitSupport": false }
}
EOF
# {"success":true}
# {"success":false,"error":"error"}
```
Example 2: Update a cron job with Axios.
```js
const axios = require('axios')
const postUrl = 'http://your-ip:1148/api/v1'
const postData = {
meta: { apiKey: 'YOUR_API_KEY', category: 'cronJob', event: 'update' },
data: { id: 'CRON_JOB_ID', command: '/usr/bin/node ~/script.js', schedule: '0 * * * *' }
}
axios
.post(postUrl, postData)
.then(res => {
console.log(res.data)
// {"success":true}
// {"success":false,"error":"error"}
})
.catch(err => {
console.log(err)
})
```
## Preview
## Todo
- [ ] Domains
- [ ] Git
- [ ] SSL
- [ ] Cron Jobs
- [ ] DNS
- [ ] Logs
- [ ] Monitor
- [ ] API
## Contribution
Feel free to contribute. Open a new [issue](https://github.com/ozgrozer/jaydon/issues), or make a [pull request](https://github.com/ozgrozer/jaydon/pulls).
## License
[MIT](license)