Skip to content

Commit 480ba00

Browse files
DEV-DIBSTERDEV-DIBSTER
committed
2 parents b336a20 + b22b7a7 commit 480ba00

File tree

4 files changed

+294
-2
lines changed

4 files changed

+294
-2
lines changed

‎src/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ This project was originally made by a bunch of DBH members to let newbies know e
3535

3636
Maintainers: [Jonfirexbox](https://github.com/kyro3400) & [DIBSTER](https://github.com/DEV-DIBSTER)
3737

38-
Original Creator: [Domin](https://github.com/domin-mnd)
38+
Original Creator: [Domin](https://github.com/dominnya)
3939

4040
!!!
4141
We're counted as a official source of knowledge. Please note that this documentation is still being worked on and things are still changing. Want to contribute to this project? Visit the documentation's [repository](https://github.com/DanBot-Hosting/Documentation-Site) for more information.
@@ -45,4 +45,4 @@ We're counted as a official source of knowledge. Please note that this documenta
4545

4646
[Privacy Policy](https://danbot.host/privacy)
4747

48-
[Terms of Service](https://danbot.host/tos)
48+
[Terms of Service](https://danbot.host/tos)

‎src/server-types/gitea.md‎

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
---
2+
icon: file
3+
---
4+
5+
# Gitea
6+
7+
Gitea is an open-source forge software package for hosting software development version control using Git as well as other collaborative features like bug tracking, wikis and code review. It supports self-hosting but also provides a free public first-party instance.
8+
9+
!!!
10+
It is important to thoroughly read and follow this guide, as one mistake might end up in you having to recreate the server.
11+
!!!
12+
13+
!!!
14+
This guide is not fully completed yet. If you don't know what you're doing, then wait until the guide is completed.
15+
!!!
16+
17+
---
18+
19+
## Requirements
20+
21+
- Have an account created and linked to the panel. [Click here if you have not done so already.](/getting-started)
22+
23+
---
24+
25+
## Creating the server
26+
27+
To create a free server, go into `#⌛╏commands` and run `DBH!server create gitea [optional server name]` to create a free server. Once you have done so, the bot should return the following output.
28+
29+
```
30+
Server Successfully Created
31+
Click Here to Access Your Server
32+
Status: User ID: Type:
33+
Created 16464 gitea
34+
Server Name:
35+
Untitled Server (settings -> server name)
36+
```
37+
38+
If you are creating a donator server, instead run `DBH!server create-donator gitea [optional server name]`
39+
40+
---
41+
42+
## Configuration
43+
44+
Once the server has finished installing, go to files, then open the `custom` folder and finally open `app.ini`.
45+
46+
Gitea has an SSL bug, so your browser won't access the server via the server's default domain because the SSL certificate is broken. **We recommend proxying the domain.**
47+
Now, edit the domain (just replace the 0.0.0.0) with your Proxied domain (if you have) or the server's default domain WITHOUT the port. Once done, the config should be something like this.
48+
49+
```ini
50+
[server]
51+
LOCAL_ROOT_URL = http://0.0.0.0:7714/
52+
DOMAIN = dono-XX.danbot.host
53+
HTTP_PORT = 7714
54+
DISABLE_SSH = true
55+
SSH_PORT = 2020
56+
```
57+
58+
---
59+
60+
## Creating a database
61+
62+
If you want to use a database on a different server, follow the guide for [PostgreSQL](/server-types/postgres) and note the node, password and port down as you'll need it for [the database settings.](#database-settings)
63+
64+
---
65+
66+
## Configuring the server
67+
68+
Now start the server. It may take a bit, so wait patiently.
69+
70+
Once it has started, open the site using the domain you put in the app.ini file with the server port.
71+
72+
Once done, you should be at the configuration page for Gitea.
73+
74+
You can close this page, but your configuration will not save until you finish it and click Install Gitea at the bottom of the page.
75+
76+
### Database settings
77+
78+
**Database Type:** Set it to which database you'll be using. In this case, PostgreSQL.
79+
80+
**Host:** Use the node and port your PostgreSQL server is on. Example: `dono-03.danbot.host:1234`
81+
82+
**Username:** Set it to pterodactyl.
83+
84+
**Password:** Use the password you noted down earlier. If you forgot it, click [here](/server-types/postgres/#password) and follow what it says to find it.
85+
86+
**Database Name:** Set it to postgres.
87+
88+
**SSL:** Leave it as default.
89+
90+
**Schema:** Leave it as default.
91+
92+
### General settings
93+
94+
**Site Title:** Leave it as default or give it a name.
95+
96+
**Repository Root Path, Git LFS Root Path & Run As Username:** LEAVE IT AS DEFAULT. It's your fault if you edit them and Gitea doesn't work.
97+
98+
**Server Domain:** If you set it up in `app.ini` you won't need to edit this.
99+
100+
**SSH Server Port:** Leave the box empty.
101+
102+
**Gitea HTTP Listen Port:** LEAVE IT AS DEFAULT.
103+
104+
**Gitea Base URL:** Leave it as default unless you are using a proxied domain. If you are, then remove the port.
105+
106+
**Log path:** Leave it as default.
107+
108+
### Optional settings
109+
110+
These settings will not be explained as thoroughly, but it is suggested to read this.
111+
112+
**Email settings**
113+
114+
This setting is not needed as Gitea is intended for private use, but if you want you can add an email server so you can get updates of your repositories.
115+
116+
**Server and Third-Party Service Settings**
117+
118+
Here you can set up Services that will work with Gitea. Hover your mouse over any option for more information.
119+
120+
**Administrator Account Settings**
121+
122+
You can add an admin account now to make it simpler, but if you don't, the first account created will be admin by default.
123+
124+
---
125+
126+
## Configuration & installation conclusion
127+
128+
After clicking "Install Gitea" you should be patient and **wait** until Gitea gets installed successfully. You can see the progress in the server's logs.
129+
130+
---
131+
132+
## 504 Gateway Time-out and 503 Bad Gateway
133+
134+
This is a very common error and may appear during installation. This is due to the server still installing and maybe rebooting. **DON'T RELOAD OR PRESS F5 AS YOU WILL START THE PROCESS AGAIN OR BREAK THE INSTALLATION.** To reload, just type the server's domain back in. **NEVER RELOAD.**
135+
136+
---
137+
138+
Once it has installed, you should be brought to the main page of Gitea. Once you are here, you can safely reload the web page without issue.

‎src/server-types/postgres.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
icon: file
3+
---
4+
5+
# PostgreSQL
6+
7+
[PostgreSQL](https://www.postgresql.org/), also known as Postgres, is a free and open-source relational database management system emphasizing extensibility and SQL compliance. PostgreSQL features transactions with atomicity, consistency, isolation, durability properties, automatically updatable views, materialized views, triggers, foreign keys, and stored procedures.
8+
9+
---
10+
11+
## Requirements
12+
13+
- Have an account created and linked to the panel. [Click here if you have not done so already.](/getting-started)
14+
15+
---
16+
17+
## Creating the server
18+
19+
Here at DBH, we have two different versions of Postgres. We have Postgres14 and Postgres16. They are both relatively the same, but just a different version.
20+
21+
To create a free server, go into `#⌛╏commands` and run `DBH!server create (postgres14|postgres16) [optional server name]` to create a free server. Once you have done so, the bot should return the following output.
22+
23+
```
24+
Server Successfully Created
25+
Click Here to Access Your Server
26+
Status: User ID: Type:
27+
Created 16464 (postgres14|postgres16)
28+
Server Name:
29+
Untitled Server (settings -> server name)
30+
```
31+
32+
If you are creating a donator server, instead run `DBH!server create-donator (postgres14|postgres16) [optional server name]`
33+
34+
---
35+
36+
## Connecting to the database
37+
38+
In order to connect to your database, start the server and use the following connection string:
39+
```
40+
postgres://pterodactyl:<PASSWORD>@dono-XX.danbot.host:<port>/postgres
41+
```
42+
43+
---
44+
45+
## Fields
46+
47+
The given connection string above will not be enough to connect to the database. Now you need to modify it to be able to connect.
48+
49+
### Node
50+
51+
Replace "dono-XX.danbot.host" with the server's node. Below is a table with the node domains.
52+
53+
| Free Node | Domain |
54+
| :-------- | :----------------- |
55+
| PNode 1 | pnode1.danbot.host |
56+
57+
| Dono Node | Domain |
58+
| :-------- | :------------------ |
59+
| Dono 01 | dono-01.danbot.host |
60+
| Dono 03 | dono-03.danbot.host |
61+
62+
### Password
63+
64+
Your server's password can be found in the startup tab under the variable `Superuser Password`.
65+
66+
### Port
67+
68+
You must use your server's assigned port found on the main page after the node domain. Example: `dono-03.danbot.host:1234`
69+
70+
---
71+
72+
## Final result
73+
74+
Once you have finished modifying the connection string, it should look like this:
75+
76+
```
77+
postgres://pterodactyl:[email protected]:1234/postgres
78+
```

‎src/server-types/redis.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
icon: file
3+
---
4+
5+
# Redis
6+
7+
[Redis](https://redis.io/) is a source-available, in-memory storage, used as a distributed, in-memory key–value database, cache, and message broker, with optional durability. Because it holds all data in memory and because of its design, Redis offers low-latency reads and writes, making it particularly suitable for use cases that require a cache. Redis is the most popular NoSQL database, and one of the most popular databases overall.
8+
9+
---
10+
11+
## Requirements
12+
13+
- Have an account created and linked to the panel. [Click here if you have not done so already.](/getting-started)
14+
15+
---
16+
17+
## Creating the server
18+
19+
To create a free server, go into `#⌛╏commands` and run `DBH!server create redis [optional server name]` to create a free server. Once you have done so, the bot should return the following output.
20+
21+
```
22+
Server Successfully Created
23+
Click Here to Access Your Server
24+
Status: User ID: Type:
25+
Created 16464 redis
26+
Server Name:
27+
Untitled Server (settings -> server name)
28+
```
29+
30+
If you are creating a donator server, instead run `DBH!server create-donator redis [optional server name]`
31+
32+
---
33+
34+
## Connecting to the database
35+
36+
In order to connect to your database, start the server and use the following connection string:
37+
```
38+
redis://default:<PASSWORD>@dono-XX.danbot.host:<port>
39+
```
40+
41+
---
42+
43+
## Fields
44+
45+
The given connection string above will not be enough to connect to the database. Now you need to modify it to be able to connect.
46+
47+
### Node
48+
49+
Replace "dono-XX.danbot.host" with the server's node. Below is a table with the node domains.
50+
51+
| Free Node | Domain |
52+
| :-------- | :----------------- |
53+
| PNode 1 | pnode1.danbot.host |
54+
55+
| Dono Node | Domain |
56+
| :-------- | :------------------ |
57+
| Dono 01 | dono-01.danbot.host |
58+
| Dono 03 | dono-03.danbot.host |
59+
60+
### Password
61+
62+
Your server's password can be found in the startup tab under the variable `Redis Password`.
63+
64+
### Port
65+
66+
You must use your server's assigned port found on the main page after the node domain. Example: `dono-03.danbot.host:1234`
67+
68+
---
69+
70+
## Final result
71+
72+
Once you have finished modifying the connection string, it should look like this:
73+
74+
```
75+
redis://default:[email protected]:1234
76+
```

0 commit comments

Comments
 (0)