1. Home
  2. Docs
  3. Applications
  4. Welcome


By: Manuel
Created: 2019-Jul
Updated: 2020-Jan-26

The EndeavourOS Welcome app is one of the first apps to encounter, both while installing EndeavourOS, and when starting the installed system.

The purpose of the Welcome app is to help users

  • find relevant information about EndeavourOS
  • provide an easy way to do some useful operations on the system

Note that the Welcome app is under constant development, and will include more features, as well as bug fixes, over time.

Below we’ll go through the window tabs of the Welcome app.


This window is what you’ll see when starting to install EndeavourOS:

This is the contents of the INSTALL tab.

This tab is useful mainly in the install phase, selected by default when installing the system.

To start the install process, simply click the Start the Installer button. In addition to the installer window, it starts a terminal window that shows plenty of detail of the install process.

Button Update this app! fetches the latest version of the Welcome app from the EndeavourOS repository, and restarts it. This can be useful when the Welcome app is updated after releasing the installer ISO.

Buttons Partition manager and Initialize pacman keys may help you, for example, to create a special partitioning, or initializing mirroring framework. But usually, these two buttons are rarely needed. The other buttons direct you to certain specific areas of more information at the EndeavourOS web site.

General Info

The next tab contains links to general information about EndeavourOS. This may be quite useful for users that know very little or nothing about EndeavourOS.

The General Info tab contents look like this:

As you can probably guess, the buttons contain links to much more information at the EndeavourOS web site.

And since developing and maintaining a distribution takes resources that the development team must pay for, we’d appreciate any size of donation (the Donate button) to help us cover the mandatory costs.

After Install

Note you’ll see the following Welcome tabs after you have installed EndeavourOS, rebooted, and logged in the your new system. The General Info tab has the same contents now as while installing.

The next tab is (as some might say) where the real fun starts!

This tab (and the last tab) are meant to be used (mainly) in the installed system.

The Update Mirrors button is recommended to be clicked as the first thing after logging in the first time. It creates a list of good mirrors for your system. And you’ll use precisely those mirrors when updating the system, or installing new packages to it. Note that you may use this button also at a later time, for example if any of the listed mirrors is no more available, or should you have other problems with mirrors.
The terminal command to run this is: reflector-simple

The next button, Update System, is also a very important button. Click it right after the “Update Mirrors” operation has finished, and your system will be up-to-date (and may need to be rebooted). This button can be used later, too. It is recommended to update system at least about once a week.

After the two tasks above are finished, your system is ready to be used.

Detect system issues makes some ad hoc checks about e.g. unneeded settings or packages. If it detects any issues, it will show what it is planning to do, and then (if allowed) performs those actions.

EndeavourOS to latest? button tries to bring an older EndeavourOS installation to the latest “design level” of packages. Note that it is a work in progress, and certainly not a requirement.

You may change the Display Manager by clicking the Change Display Manager button. Usually this is not needed, but you may know a reason for doing so.

The EndeavourOS wallpaper button assigns the default EndeavourOS wallpaper back. This may be handy after experimenting with other wallpapers. Note also that this button uses the program eos-set-background-picture, and that program can be used to set the wallpaper directly on the command line.

Other buttons under this tab include more links to information about either useful or more advanced things. All users (unless already familiar with the topics) are recommended to check the links under “Package management” and “AUR & yay!” buttons. Buttons related to hardware may also be very useful if you have that hardware. And “Forum tips” provides general tips for Forum usage.

Add More Apps

The last tab includes buttons for installing some popular applications.

Even though these apps are popular and useful, we’ve chosen not to install them by default. This gives users a better opportunity to “tailor” their system, but still, have an easy way to install these apps. The packages behind the buttons are:

  • libreoffice-fresh
  • chromium
  • gufw
  • blueberry with bluez-utils

By the way, do you remember that the previous tab included a button “AUR & yay!”? As you (should!) know by now, pacman is the main package manager in EndeavourOS. It manages packages that are available from the Arch Linux repositories. But there is a huge amount of more apps available in the AUR (Arch User Repository). AUR is not managed by pacman. That’s why EndeavourOS provides another package manager, yay. It is like pacman, but supports AUR applications in addition to Arch Linux repositories.

Community member and Moderator Ricklinux discovered a bug that affects the Welcome app on the Cinnamon desktop and it looks like this:


Until now a solution hasn’t been found but the workaround is simple. Go to the preferences menu and disable window effects like this:

Screenshot from 2020-01-01 11-36-38

Special note about the code

The welcome app includes code that is directly used by some other apps, like eos-update-notifier. The shared code files are:


  • contains functions common for the using programs

/etc/eos-script-lib-yad.conf contains the following settings for the using programs:

  • EOS_YAD_TERMINAL: name of the terminal program. With this you can force your favorite terminal to be used with the apps welcome and update notifier. But please note that it is possible that the terminal you select may not be compatible with the way the above programs use it, especially if it is not on the list of compatible terminals. By default this is commented out, and one of the supported terminals is used.
  • EOS_ROOTER: chooses the program to give elevated privileges for running programs in the terminal. Supported programs are
    • su (default)
    • su-c_wrapper
    • sudo
    • pkexec
  • EOS_WELCOME_CONNECTION_WARNING: specifies whether the welcome app shows the warning about missing internet connection or not. Values are simple “yes” or “no”.
  • EOS_CONNECTION_CHECKER: configures the program to be used for checking if internet connection is available. Supported values are “ping” or “curl”.
  • TERMINAL_AT_START: if properly set, makes the welcome app to start a terminal whenever the welcome app is started. See details at the config file.
  • EOS_WIFIDEV_CHECK: enable or disable certain ad hoc checks about the wifi driver. The checks are made by clicking the Detect system issues button of the welcome app.
  • EOS_KEEP_PKGS: lists the name pf packages that shouldn’t be removed when the Detect system issues button is clicked.


The Welcome app will become more powerful over time.
The purpose of Welcome is not to give all possible help in all possible situations, but simply help to go in the right direction without a great hassle. And Welcome should provide more useful features in the future, so it is not a helper only in the beginning, but a truly useful app to have and keep using.

So, enjoy!

Follow us
Was this article helpful to you? Yes 5 No 1

How can we help?