This will be the domain used by your server's users to access the authentication portal. You can later add other domains, and change which one is the main domain if needed.
You will have to choose a fake domain, since it will not be accessible from outside.
ynh.wsl. The tricky part is advertising this domain to your host.
C:\Windows\System32\drivers\etc\hosts file. You should have a line starting by
::1, update it or add it if needed to get:
::1 ynh.wsl localhost
If you want to create subdomains, do not forget to add them in the
hosts file too:
::1 ynh.wsl subdomain.ynh.wsl localhost
This password will be used to access to your server's administration interface. You will also use it to connect via SSH or SFTP . In general terms, this is your system's key, choose it carefully!
Once the postinstall is done, you should be able to actually log in the web admin interface using the administration password.
So far, your server now has an
admin user - but
admin is not a "regular" user and can't be used to log on the user portal.
Let's therefore add a first "regular" user.
The first user you create is a bit special : it will receive emails sent to
firstname.lastname@example.org. These emails may be used to send technical informations or alerts.
Go in Users > Click on "+ New User" button
yunohost user create johndoe
Reminder: YunoHost in WSL will likely not be reachable from outside, and real domains and certificates won't be able to be assigned to it.
The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected.
N.B. : don't run away ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to configure DNS records (if not using a
ynh.fr domain), add a swapfile if not enough ram .
If an alert is not relevant (for example because you don't intend on using a specific feature), it is perfectly fine to flag the issue as 'ignored' by going in the webadmin > Diagnosis, and clicking the ignore button for this specifc issue.
To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial diagnosis and you should get a screen like this :
yunohost diagnosis run yunohost diagnosis show --issues --human-readable
Once you configured DNS records and port forwarding (if needed), you should be able to install a Let's Encrypt certificate. This will get rid of the spooky security warning from earlier for new visitors.
For more detailed instructions, or to lean more about SSL/TLS certificates, see the corresponding page here.
Go in Domains > Click on your domain > SSL Certificate
yunohost domain cert install
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at the guided tour. You should also be able to install your favourite applications. Don't forget to plan backups !
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to suggest changes.