Skip to content

Commit 28e148e

Browse files
fix(tuto): netbox
1 parent 2e3c805 commit 28e148e

File tree

3 files changed

+38
-44
lines changed

3 files changed

+38
-44
lines changed

tutorials/configure-netbox-managed-postgresql-database/index.mdx

Lines changed: 35 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ categories:
1010
- postgresql-and-mysql
1111
hero: assets/scaleway_netbox.webp
1212
dates:
13-
validation: 2024-10-29
13+
validation: 2025-05-14
1414
posted: 2019-11-14
1515
---
1616

@@ -24,30 +24,20 @@ In this tutorial, you learn how to install and configure NetBox on an Instance r
2424
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2525
- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/)
2626
- An [Instance](/instances/how-to/create-an-instance/) running Ubuntu Focal Fossa (20.04 LTS) or later
27-
- A [Database for PostgreSQL](/managed-databases-for-postgresql-and-mysql/quickstart/)
27+
- A [Managed Database for PostgreSQL](/managed-databases-for-postgresql-and-mysql/quickstart/)
2828

2929
## Configuring the database
3030

3131
NetBox requires a PostgreSQL database. Configure your [Database for PostgreSQL](https://www.scaleway.com/en/database/) with a few steps from your [Scaleway console](https://console.scaleway.com/rdb/instances)
3232

3333
1. Enter the Databases section of your [Scaleway console](https://console.scaleway.com/rdb/instances) by clicking on **Managed Databases** in the side menu.
34-
2. Click the name of the Database you want to use to view the Instance's details:
35-
<Lightbox src="scaleway-db_instance_list.webp" alt="" />
36-
3. Click the **Managed Databases** tab to view the databases of your Instance.
37-
<Lightbox src="scaleway-dbaas_databases_list.webp" alt="" />
38-
4. Click **+ Add Database**. The new database dialog appears.
39-
5. Enter the name for the new database (`netbox`) and click **Create Database** to launch the database creation:
40-
<Lightbox src="scaleway-dbaas_new_db.webp" alt="" />
41-
6. Select the **Users** tab to view the users of your Database Instance.
42-
7. Click **+ Add user** to create a new `netbox` user for the database. Enter the identifier and password for the user:
43-
<Lightbox src="scaleway-dbaas_new_user.webp" alt="" />
44-
8. Then click the **Permissions** tab and set **ALL** permissions for the user on the `netbox` table.
45-
9. Once done, click **Create a user** to validate the form and launch the user creation process:
46-
<Lightbox src="scaleway-dbaas_permissions.webp" alt="" />
34+
2. [Create a Database Instance.](/managed-databases-for-postgresql-and-mysql/how-to/create-a-database/)
35+
3. [Create a database](/managed-databases-for-postgresql-and-mysql/how-to/add-a-database/) called `netbox`.
36+
4. [Create a new user](/managed-databases-for-postgresql-and-mysql/how-to/add-users/) also called `netbox` and grant it ALL permissions to the `netbox` database.
4737

4838
## Installing NetBox
4939

50-
1. Log into your Instance using [SSH](/instances/how-to/connect-to-instance/).
40+
1. Connect to your Instance using [SSH](/instances/how-to/connect-to-instance/).
5141
2. Update the `apt` package cache and upgrade the software already installed on the Instance to the latest version available in Ubuntu's repositories:
5242
```
5343
apt update && apt upgrade -y
@@ -56,13 +46,13 @@ NetBox requires a PostgreSQL database. Configure your [Database for PostgreSQL](
5646
```
5747
apt install -y libpq-dev python3 python3-pip python3-dev python3-venv build-essential libxml2-dev libxslt1-dev libffi-dev graphviz libpq-dev libssl-dev redis-server zlib1g-dev git nginx
5848
```
59-
4. Download the [latest release](https://github.com/netbox-community/netbox/releases/latest) of NetBox. At the time of writing this tutorial, it is version 3.7.5. Unpack it into the `/opt` directory:
49+
4. Download the [latest release](https://github.com/netbox-community/netbox/releases/latest) of NetBox. At the time of writing this tutorial, it is version 4.3.1. Unpack it into the `/opt` directory:
6050
```
61-
wget https://github.com/netbox-community/netbox/archive/refs/tags/v3.7.5.tar.gz && tar -xzf v3.7.5.tar.gz -C /opt
51+
wget https://github.com/netbox-community/netbox/archive/refs/tags/v4.3.1.tar.gz && tar -xzf v4.3.1.tar.gz -C /opt
6252
```
6353
5. Create a symlink from the actual NetBox directory to `/opt/netbox`:
6454
```
65-
ln -s /opt/netbox-3.6.3/ /opt/netbox
55+
ln -s /opt/netbox-4.3.1/ /opt/netbox
6656
```
6757
6. Create a new system user for the NetBox application:
6858
```
@@ -103,29 +93,33 @@ NetBox requires a PostgreSQL database. Configure your [Database for PostgreSQL](
10393
- `REDIS` specifies the configuration parameters of Redis, an in-memory key-value store required as part of the NetBox installation. For most installations, the default configuration is good enough, and you can leave it as it is. For more information about advanced Redis configuration, refer to the [official documentation](https://docs.netbox.dev/en/stable/configuration/required-parameters/#redis).
10494
- `SECRET_KEY` specifies a secret cryptographic key that is used to improve the security of cookies and password resets. It should be at least 50 characters long and should not be shared outside the configuration file. You may change the value of the key at any time, resulting in a termination of all active sessions.
10595

106-
Enter the key in the configuration file as follows, then save the file and exit your text editor:
107-
```
108-
SECRET_KEY = 'uyK5ajt-Vl$!gd2HeLbN=^6@&EhDmv8%)zT1S03kXPCsUGrI9_'
109-
```
96+
Enter the key in the configuration file as follows, then save the file and exit your text editor:
97+
98+
```
99+
SECRET_KEY = 'uyK5ajt-Vl$!gd2HeLbN=^6@&EhDmv8%)zT1S03kXPCsUGrI9_'
100+
```
101+
102+
<Message type="important">
103+
104+
The `SECRET_KEY` is not used for hashing user passwords or for the encrypted storage of secret data in NetBox.
105+
NetBox comes with a script, that you may use to generate a random key:
110106

111-
<Message type="important">
112-
The `SECRET_KEY` is not used for hashing user passwords or for the encrypted storage of secret data in NetBox.
113-
NetBox comes with a script, that you may use to generate a random key:
114-
```
115-
python3 /opt/netbox/netbox/generate_secret_key.py
116-
```
117-
</Message>
118-
12. Once NetBox has been configured, proceed with the actual installation by running the packaged upgrade script (`upgrade.sh`):
107+
```
108+
python3 /opt/netbox/netbox/generate_secret_key.py
109+
```
110+
</Message>
111+
112+
12. Once NetBox is configured, proceed with the actual installation by running the packaged upgrade script (`upgrade.sh`):
119113
```
120114
/opt/netbox/upgrade.sh
121115
```
122116

123117
This script performs the following actions on your instance:
124118

125-
- Creating a Python virtual environment
126-
- Installing all required Python packages
127-
- Running database schema migrations
128-
- Aggregating static resource files on disk
119+
- Creating a Python virtual environment
120+
- Installing all required Python packages
121+
- Running database schema migrations
122+
- Aggregating static resource files on disk
129123

130124
<Message type="note">
131125
The upgrade script may warn you, that no existing virtual environment was detected. As this is a new installation, you can safely ignore this warning.
@@ -150,7 +144,7 @@ NetBox does not come with any default user accounts. Create a first user by comp
150144
python3 manage.py createsuperuser
151145
```
152146

153-
Enter the `username`, `email`, `password`, and `password confirmation` for the user and confirm by pressing Enter. The following message displays once the user is created: `Superuser created successfully.`
147+
4. Enter the `username`, `email`, `password`, and `password confirmation` for the user and confirm by pressing Enter. The following message displays once the user is created: `Superuser created successfully.`
154148

155149
## Testing the application
156150

@@ -165,10 +159,10 @@ Enter the `username`, `email`, `password`, and `password confirmation` for the u
165159

166160
[gunicorn](https://gunicorn.org/) is a Python [WSGI](https://wsgi.readthedocs.io/en/latest/what.html) HTTP Server for UNIX which will be used to serve the NetBox application to Nginx.
167161

168-
1. Copy the gunicorn configuration file from the `contrib` directory to its final destination:
169-
```
170-
cp /opt/netbox/contrib/gunicorn.py /opt/netbox/gunicorn_config.py
171-
```
162+
Copy the gunicorn configuration file from the `contrib` directory to its final destination:
163+
```
164+
cp /opt/netbox/contrib/gunicorn.py /opt/netbox/gunicorn_config.py
165+
```
172166

173167
The configuration file shipped with the NetBox application works for most setups, however, if you need some specific settings, refer to the [gunicorn documentation](https://docs.gunicorn.org/en/stable/configure.html).
174168

@@ -221,7 +215,7 @@ To provide an additional layer of security, NetBox will be running behind a [NGI
221215
}
222216
```
223217

224-
Save the file and exit the text editor.
218+
Save the file and exit the text editor.
225219
3. Create a symlink to enable the new configuration with NGINX:
226220
```
227221
ln -s /etc/nginx/sites-available/netbox.conf /etc/nginx/sites-enabled/netbox.conf

tutorials/configure-tem-smtp-with-wordpress-plugin/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ categories:
1010
- transactional-email
1111
- instances
1212
dates:
13-
validation: 2024-10-29
13+
validation: 2025-05-14
1414
posted: 2024-04-24
1515
---
1616

tutorials/zulip/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ hero: assets/scaleway_zulip.webp
1010
categories:
1111
- instances
1212
dates:
13-
validation: 2024-11-04
13+
validation: 2025-05-14
1414
posted: 2021-10-21
1515
---
1616

@@ -97,7 +97,7 @@ Your Zulip is now running, however, it cannot send any email notifications in it
9797
- Activate TLS for outgoing mails: `EMAIL_USE_TLS = True`
9898
- Set the SMTP port: `EMAIL_PORT = 587`
9999

100-
Save the file by pressing `CTRL`+`O` and leave nano by pressing `CTRL`+`X`.
100+
Save the file by pressing `CTRL`+`O` and leave nano by pressing `CTRL`+`X`.
101101
3. Open Zulip's secrets file `/etc/zulip/zulip-secrets.conf` in a text editor like `nano` and add the email password at the end of the file, as shown in the following example:
102102
```
103103
[...]

0 commit comments

Comments
 (0)