1. Environment and Network Preparation
1.1 Hardware Requirements
Architectural Requirement Specifications
Server | CPU Requirements | Memory Requirements | Storage Requirements | Operating System Requirements |
mavis server | 4 Core | 16 GB | 40 GB or more (/) | Ubuntu 16.04, 18.04, 20.04, 22.04, 23.10, 24.04 the account needs to have sudo permissions |
1.2 Prepare a Wildcard Domain Certificate and Configure DNS Subdomains
The Mavis service is accessed via a URL that you set up, so a full domain name and configuration are required.
For example, the domain is example.com, and the SSL registration covers *.example.com.
Subdomain | Record Type | Resolution Content | Description |
mavis | A | mavis IP Address | Used for platform login |
1.3 Domain SSL Certificate
If the target server does not have an SSL certificate, some functions will not be available. (Ensure that the intermediate certificate is included when installing the SSL certificate to ensure proper operation.)
Step 1: Upload the SSL certificate files (including the certificate itself and the CA bundle, also known as the intermediate certificate, usually in .crt and .key file formats) to the server path to execute the installation script.
Step 2: Prepare your SSL certificate fullchain.cer and private key, and rename them to tls.crt and tls.key respectively. If you are using a Let’s Encrypt certificate, refer to the Free SSL Certificate Application - Let’s Encrypt (90-day validity).
Example of tls.crt: includes the certificate itself and the CA bundle (also known as the intermediate certificate).
1.4 Network Configuration
Mavis needs access to the internet to download necessary components.
No. | Source | Destination | Protocol / Port | Rule | Description |
1 | Mavis IP Address | 0.0.0.0/0 (Internet) | ALL | Allow |
Allow the Mavis platform to access the internet to download necessary components |
K3s Installation Network Range Reminder:
K3s uses the default network ranges 10.42.0.0/16 and 10.43.0.0/16.
If your company's internal network or other devices are
already using these ranges, conflicts may occur.
If you need to adjust the K3s network range settings before installation,
please contact us!
2. Appendix: Pre-deployment Checklist
No. | Item | Check Result | Remarks |
---|---|---|---|
1 |
Operating System: (Ubuntu 16.04, 18.04, 20.04, 22.04, 23.10,24.04) |
□ Yes □ No |
|
2 |
CPU: 4 Core or higher |
□ Yes □ No |
|
3 |
Memory: 16 GB or higher |
□ Yes □ No |
|
4 |
Hard Disk: 40 GB or higher |
□ Yes □ No |
|
5 |
Root access |
□ Yes □ No |
|
6 |
Prepare a domain |
□ Yes □ No |
|
7 |
Configure DNS for Mavis |
□ Yes □ No |
|
8 |
Wildcard SSL certificate |
□ Yes □ No |
|
9 |
Check server’s internet access |
□ Yes □ No |