Editing FAQ

<languages/>
<translate>
<!--T:1-->
This document aims to cover the most frequently asked questions concerning the GhostBSD operating system. 

<!--T:2-->
Every effort has been made to make this FAQ as informative as possible; if you have any suggestions as to how it may be improved, please feel free to contact us.

== '''Introduction''' == <!--T:3-->

=== What is GhostBSD? === <!--T:4-->

<!--T:5-->
Briefly, GhostBSD is a [[wikipedia:en:Unix-like|UNIX®-like]] [[wikipedia:en:Operating system|operating system]]. It works on AMD64 and Intel® platforms. GhostBSD is based on TrueOS. Trueos is based on [[wikipedia:en:FreeBSD|FreeBSD]], which is based on U.C. Berkeley’s “[[wikipedia:en:4.4BSD|4.4BSD]]-Lite” release, with some “[[wikipedia:en:4.4BSD|4.4BSD]]-Lite2” enhancements. It is also based indirectly on William Jolitz’s port of U.C. Berkeley’s “Net/2” to the i386, known as “[[wikipedia:en:386BSD|386BSD]]”, though very little of the 386BSD code remains. GhostBSD provides a [[MATE]] desktop.

=== Who can use GhostBSD? === <!--T:6-->

<!--T:7-->
GhostBSD can be used by companies, researchers, computer professionals, students and home users all over the world in their work, education, and recreation.

=== What is the goal of the GhostBSD Project? === <!--T:8-->

<!--T:9-->
The goal of the GhostBSD Project is to combine the ease of use of a set of [[wikipedia:en:GTK|GTK]] [[wikipedia:en:Desktop environment|desktops]] with security and flexibility of the underlying TrueOS mechanisms. GhostBSD is a great tool to learn TrueOS and start one’s adventure in the BSD world. GhostBSD may be used for any purpose and without strings attached.

=== Does the GhostBSD license have any restrictions? === <!--T:10-->

<!--T:11-->
Yes. Those restrictions do not control how you use the code, merely how you treat the GhostBSD Project itself. If you have serious license concerns, read the actual license. For the simply curious, the license can be summarized like this:
* Do not claim that you wrote this.
* Do not sue us if it breaks.

=== Can GhostBSD replace my current operating system? === <!--T:12-->

<!--T:13-->
For most users, yes.

<!--T:14-->
Most people do not actually use an operating system. They use applications, as these are what really makes a computer useful. GhostBSD is designed to provide a [[wikipedia:en:Desktop environment|desktop]] and full-featured environment for applications. It supports a wide variety of web browsers, office suites, email readers, graphics programs, programming environments, network servers, and just about everything else you might want. Most of these applications can be built using the TrueOS Ports Collection.

<!--T:15-->
If you need to use an application that is only available on one operating system, you cannot easily replace that operating system (this situation is referred to as [[wikipedia:en:Vendor_lock-in|vendor lock-in]]). However, chances are that there is a very similar application on GhostBSD, however. If you want a solid office or internet server, a reliable workstation, or just the ability to do your job without interruptions, GhostBSD will almost certainly do everything you need.

<!--T:16-->
If you are migrating to GhostBSD from some other [[wikipedia:en:Unix-like|UNIX®-like]] environment, you already know most of what you need to know. If your background is in graphic-driven operating systems such as [[wikipedia:en:Microsoft_Windows|Microsoft Windows®]] and older versions of [[wikipedia:en:OS_X|MacOS®]], expect to invest additional time learning the [[wikipedia:en:Unix|UNIX]] way of doing things.

=== Why is it called GhostBSD? === <!--T:17-->

<!--T:18-->
At first, GhostBSD did mean "<tt>Gnome haked operating system technology on FreeBSD<tt>" which later it became what was referred to as “<tt>Gnome hosted on BSD</tt>.” However, at present, GhostBSD supports the MATE desktop environment, so it is more accurate to refer to GhostBSD as "<tt>GTK hosted on BSD</tt>."

=== What is the latest version of GhostBSD? === <!--T:19-->

<!--T:20-->
At this point in time, we are at version 18.10.

<!--T:21-->
Releases are usually made every several months.

<!--T:22-->
Version 19.02 is next to come, following the release cycle of TrueOS.

<!--T:23-->
Many GhostBSD users stay up to date using other mechanisms available to TrueOS users.

=== When are GhostBSD releases made? === <!--T:24-->

<!--T:25-->
The developer's team releases a new version more or less every several &nbsp;months. GhostBSD follows the release dates of TrueOS. A testing period precedes each release in order to ensure that the addition of new features does not compromise the stability of the release.

=== How can I contribute? === <!--T:26-->

<!--T:27-->
There are several ways to contribute to the GhostBSD project:
* If you are a programmer and want to learn more about the TrueOS operating system, consider becoming a developer.
* If you are artistically inclined, consider helping us create fan art, logos, wallpapers, or help design/maintain the website layout.
* If you have good writing skills and know English well, consider helping us by producing content for the website and wiki.
* If you find a software problem (i.e., bug), please submit a problem report (PR) [http://issues.ghostbsd.org here].
* If none of the above apply to you, consider using GhostBSD and report any bugs you've discovered or any ideas that you might have about how to improve the system. You might also consider simply spreading the word about GhostBSD!

<!--T:28-->
If you want to contribute in any way, please reach out to us via Telegram https://t.me/ghostbsd, IRC Freenode [http://ghostbsd.org/irc/ #ghostbsd], or [http://forums.ghostbsd.org/ GhostBSD Forums].

== '''Support''' == <!--T:29-->

=== What’s the best way to get support? === <!--T:30-->

<!--T:31-->
At this point, the best ways to contact other GhostBSD users or developers are:
* Telegram at https://t.me/ghostbsd
* The IRC channels are <code>#ghostbsd</code> and <code>#ghostbsd-dev</code> on irc://irc.freenode.net.
* You can access the IRC channel [http://ghostbsd.org/irc/ via our web user interface].
* The forums are available at http://forums.ghostbsd.org/


<!--T:32-->
[[FAQ]] and [[GhostBSD User Handbook | User Handbook]] are under development. Questions can be answered on the forums and IRC will find their way to this page or the handbook.

=== Where can I find complete information on how to get things done in GhostBSD? === <!--T:33-->

<!--T:34-->
For the most part, things can be done on GhostBSD the same way they are done on TrueOS. This is why we encourage our users to check out the great [http://www.freebsd.org/doc/handbook/ FreeBSD Handbook] and TrueOS Handbook in case of any doubts or questions. If the handbooks do not cover a specific area of your interest, the Telegram channel will probably hold the answers you seek.

== '''Installation''' == <!--T:35-->

=== Where can I get GhostBSD? === <!--T:36-->

<!--T:37-->
Every release image of GhostBSD is available via [https://sourceforge.net/projects/ghostbsdproject/files/release/ SourceForge] site:
* The latest releases images can be found on the [http://ghostbsd.org/download/ Download] page.
* Our Torrent file are available from [http://www.gotbsd.net GotBSD] or from the [http://www.ghostbsd.org/torrent project page] (currently not up to date). 
* You can also buy GhostBSD DVDs and USB flash drives from [http://www.osdisc.com/products/ghostbsd?affiliate=ghostbsd OSDisc.com].

All image checksums, hybrid ISO (DVD, USB) and torrent, are available [https://www.ghostbsd.org/download here].

=== How do I create a bootable USB pendrive? === <!--T:38-->

<!--T:39-->
Up to version 4.0 separate USB images (with the ''.img'' extension) existed that were suitable for USB flash drives. Since version 10.1, GhostBSD releases so-called ''hybrid ISOs'' which can either be burned on a DVD or written on a flash drive. Select your preferred desktop and the right architecture and download the ISO. After downloading compare the checksum (optional) and write the content of the iso on a flash drive using one of the methods described below. Since the image itself can be slightly above 2&nbsp;GB in size, we suggest you use at least a 4&nbsp;GB pendrive.

Here are examples using the console (use the filename of your ISO and make sure you replace the "sdX" with the right device's name!). The following requires root privileges (issue as user ''root'' or use ''sudo'').

==== On BSD ==== <!--T:40-->

: <code>dd if=GhostBSD18.10-RC1.iso of=/dev/da0 bs=4m</code>

==== On Linux ==== <!--T:41-->

: <code>dd if=GhostBSD18.10-RC1.iso of=/dev/sdc bs=4M</code>

==== On Mac ==== <!--T:42-->

: <code>dd if=GhostBSD18.10-RC1.iso of=/dev/disk2 bs=10240</code>

==== On Windows ==== <!--T:43-->

<!--T:45-->
This solution comes from the [https://help.ubuntu.com/community/Installation/FromImgFiles#Windows Ubuntu help site], but it applies to GhostBSD as well. You can use one of two tools to create a bootable pendrive on Windows.

===== Graphical tool on Windows ===== <!--T:46-->

<!--T:47-->
# Download the desired ISO file
# Download the ''Disk Imager'' from http://sourceforge.net/projects/win32diskimager/
# Insert your flash media
# Note the drive letter assigned to your flash media
# Start ''Disk Imager''
# Select the downloaded file and target device, and click "<tt>Write</tt>"
# Remove your flash media when the operation is complete

===== Command prompt tool on Windows ===== <!--T:48-->

<!--T:49-->
# Download the desired ISO file
# Download ''flashnul'' from http://shounen.ru/soft/flashnul
# Attach your USB drive
# Run flashnul -p
# Note the physical device number for the USB drive
# Run flashnul <number obtained in prior step> -L \path\to\downloaded.iso
# Answer "<tt>yes</tt>" if the selected destination device is correct
# Remove your USB drive when the command finished

==== Conclusion ==== <!--T:50-->

<!--T:51-->
After completing the above steps, the pendrive should hold a bootable GhostBSD system. Just reboot your machine and make sure you boot from the USB - it should then start a live session.

=== Where are the instructions for installing GhostBSD? === <!--T:52-->

<!--T:53-->
Installation instructions for versions beginning with GhostBSD 3.1 can be found in the handbook entry on [[Installing GhostBSD]].

== '''Software Installation''' == <!--T:54-->

=== How do I install new software? === <!--T:55-->

<!--T:56-->
In GhostBSD software can be installed in three different ways:
* [[OctoPkg]] is a GTK+ based tool to manage (search, install and uninstall) binary packages on BSD systems.
* GhostBSD's package manager [[PKG]] can be used to manage packages using the command line.
* TrueOS' Ports is one of the most useful and unique features of GhostBSD compared to most Linux distributions.

=== Can I use Linux software on my GhostBSD system? === <!--T:57-->

<!--T:58-->
First, you should know that most "Linux" software is really ''open source'' software. That is, it is freely available for many operating systems, not just Linux. There are some programs that make use of Linux exclusive features (we call those ''Linuxisms'') that won't run anywhere else. A very high amount of popular projects however care for ''portability'' and make sure that their software will build and work on multiple operating systems.

<!--T:59-->
Even if the program that you are looking for is not available as a package it can probably be built on GhostBSD. Just give it a try if you know how to compile software yourself. You can always ask on the forums if you need help. Somebody in the community might be able to help you. If you get the program to work, tell us! If you want the program to be available as a package in the future, a [[wikipedia:en:FreeBSD_Ports|port]] needs to be created for it. For a lot of programs, this is not too hard to do and the FreeBSD community is very welcoming towards new porters.

<!--T:60-->
Like FreeBSD, GhostBSD provides something called Linux Binary Compatibility. In short, that means you can run many Linux applications as-is. This [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu.html section] of the FreeBSD Handbook explains Linux Compatibility in more detail and describes what to do when things don't work.

<!--T:61-->
GhostBSD comes with Linux Binary Compatibility already configured for you and it should "just work". You may want to install the '''linux_base-c7''' (based on Linux CentOS 7.4.1708) though that provides a lot of basic Linux libraries that might be needed by a lot of Linux applications. If your program needs any other libraries you'll have to provide them by manually copying them in (see [https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu-lbc-install.html this section] of the FreeBSD handbook).

<!--T:62-->
Using GhostBSD 18.10-RC1, it is even possible to run ''64 bit'' Linux binaries. In general, it does provide a means of running Linux applications on GhostBSD.

=== Does GhostBSD Support Adobe Flash plugin? === <!--T:63-->

<!--T:64-->
Yes, but a native Adobe® Flash® plugin is not available for GhostBSD. However, a software wrapper for running the Linux® version of the plugin is available. This wrapper also provides support for other browser plugins such as RealPlayer®.

<!--T:65-->
Look [[Installing Adobe Flash Plugin]]

== '''System and software updates''' == <!--T:66-->

=== How should I update GhostBSD to latest TrueOS updates? === <!--T:67-->

<!--T:68-->
GhostBSD supports trueos-update command line to update the TrueOS base system.

<!--T:69-->
: <code>trueos-update fetch install</code>

== '''Network''' == <!--T:70-->

Preliminary Reading and set of Manual bring up Instructions  [http://www.wonkity.com/~wblock/docs/html/wireless.html  Wireless Instructions for FreeBSD]  
=== My Wi-Fi doesn't work. === <!--T:71-->
[https://en.wikipedia.org/wiki/Wi-Fi]  The Wikipedia link explaining Wi-Fi terms.

<!--T:72-->
Look if the ''wlan0'' interface is configured.
: <code>cat /etc/rc.conf | grep wlan0</code>

<!--T:73-->
If you have an output similar to:
<pre>
wlans_run0="wlan0"
ifconfig_wlan0="WPA DHCP"
</pre>
Your Wi-Fi wlan0 interface is configured, but it might be down.
: <code>sudo ifconfig wlan0 up</code>
Now bring it up and it should work.

Scan for Wi-Fi access point signals
: <code>sudo ifconfig wlan0 up scan</code>
<pre>SSID/MESH ID    BSSID              CHAN RATE    S:N     INT CAPS
innflux         2c:e6:cc:25:32:18    6   54M  -86:-96   100 ES   WME HTCAP
innflux         2c:e6:cc:25:68:78    6   54M  -71:-96   100 ES   WME HTCAP
</pre>

<!--T:74-->
If you have no output, this mean the GhostBSD network configuration system has not detected your Wi-Fi PCI card or Wi-Fi USB dongle. The next step for you, will be to look if GhostBSD has your Wi-Fi drivers installed. Do you have your kernel Wi-Fi driver loaded?  Check your loaded kernel modules with '''kldstat''' command.
: <code>sudo kldstat</code>
Manually load the necessary kernel modules for your devices.  Later edit  the file /boot/loader.conf for these kernel modules to be loaded automatically during bootup.  Unload the old version of urtwn driver with '''kldunload''' command.  Example below loads newer version of the usb urtwn &  pci rtwn modules combined into one rtwn kernel module after FreeBSD 11.0-Current revision r307529.
<code>
sudo kldunload if_urtwn.ko
sudo kldload  if_rtwn.ko if_rtwn_usb.ko  if_rtwn_pci.ko
sudo kldstat
</code>

List your PCI bus devices: <code>sudo pciconf -lv </code>   none2 is the RealTek RTL8188CE internal PCI Wifi interface.  alc0 is the Atheros 10/100 Megabyte Fast Ethernet PCI interface, hard wired RJ45 ethernet input.
  
<pre>
alc0@pci0:1:0:0:	class=0x020000 card=0xff1e1179 chip=0x20621969 rev=0xc1 hdr=0x00
    vendor     = 'Qualcomm Atheros'
    device     = 'AR8152 v2.0 Fast Ethernet'
    class      = network
    subclass   = ethernet
none2@pci0:2:0:0:	class=0x028000 card=0x818110ec chip=0x817610ec rev=0x01 hdr=0x00
    vendor     = 'Realtek Semiconductor Co., Ltd.'
    device     = 'RTL8188CE 802.11b/g/n WiFi Adapter'
    class      = network
</pre>

List your USB devices looking for a wireless Wi-Fi usb dongle :<code>usbconfig  or usbconfig dump_info or usbconfig list</code>
In the example "usbconfig" list below, there is '''NOT''' a WiFi usb dongle plugged into the computer system.

<pre>
ugen0.1: <Intel EHCI root HUB> at usbus0, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=SAVE (0mA)
ugen1.1: <Intel EHCI root HUB> at usbus1, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=SAVE (0mA)
ugen0.2: <vendor 0x8087 product 0x0024> at usbus0, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=SAVE (0mA)
ugen1.2: <vendor 0x8087 product 0x0024> at usbus1, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=SAVE (0mA)
ugen0.3: <Generic USB2.0-CRW> at usbus0, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=ON (500mA)
ugen0.4: <Importek TOSHIBA Web Camera> at usbus0, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=ON (500mA)
ugen1.3: <Maxtor OneTouch> at usbus1, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=ON (2mA)
</pre>

Check your interface connections for 802.11 wireless.
: <code>sudo ifconfig | grep -B 3 802.11</code>
In this case run0 is the WiFi drivers.
<pre>
run0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 2290
       ether 00:1e:e5:e6:5d:1
       nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL>
       media: IEEE 802.11 Wireless Ethernet autoselect mode 11a
</pre>
If you have an output similar from the example above, you need to configure the file ''/etc/rc.conf'' using the '''ee''' editor.
: <code>sudo ee /etc/rc.conf</code>
Add these  2 lines in the file ''/etc/rc.conf'' (replace 'run0' by your drivers).
<pre>
wlans_run0="wlan0"
ifconfig_wlan0="WPA DHCP"
</pre>

Press the [[wikipedia:en:Esc key|Esc]] and save the file. Now you need to restart network interfaces <code>netif</code>.  
once done, restart the network routing daemon:
: <code>sudo /etc/rc.d/netif restart</code>   or <code>service netif restart </code>
: <code>sudo /etc/rc.d/routing restart</code>   or <code>service routing restart </code>

Your wifi is now configured. You might have to set wlan0 interface up.
: <code>sudo ifconfig wlan0 up</code>

Last you can  manually run : <code>dhclient wlan0</code>
You might have to kill off an existing running dhclient process, to manual test getting a dynamic IP address from a dhcp server.
: <code>killall dhclient </code>:
: <code>dhclient wlan0 </code>

Print the routing table information for IP4 addresses.   You can google search for useage of FreeBSD command <code> netstat </code>
Display the kernel routing information using <code>netstat -r </code> command.  In example "routing tables" below, only print out IP4 addresses.

: <code>netstat -4r </code>
<pre>
Routing tables

Internet:
Destination        Gateway            Flags     Netif Expire
default            gateway.innflux.co UGS        alc0
10.59.0.0/19       link#1             U          alc0
10.59.24.120       link#1             UHS         lo0
localhost          link#2             UH          lo0
</pre>
<!--T:75-->
If you have no output with <code>sudo ifconfig | grep -B 3 802.11</code>, this can mean your Wi-Fi kernel module is not compiled into GhostBSD or your Wi-Fi card is not yet supported by FreeBSD. Then please complete a [http://ghostbsd.org/problem_report problem report form] Your report will help us to improve GhostBSD.

=== Why the Wi-Fi Network Manager doesn't work? === <!--T:76-->

<!--T:77-->
You might look at [[#Why my Wi-Fi doesn't work?]] (from above). If you have your Wi-Fi Configured and the Wi-Fi Network Manager still not working.
: <code>sudo ifconfig wlan0 scan</code>
You should have something similar to this:
<pre>
SSID/MESH ID    BSSID              CHAN RATE   S:N     INT CAPS
rogerwifi       bc:14:01:e6:33:48    1   54M -23:-42  100 EP   WPS HTCAP WPA RSN WME
-               bc:14:01:e6:33:49    1   54M -20:-38  100 EP   HTCAP RSN WME
WLAN_6EF1       00:13:f7:c4:6e:f3   11   54M -12:-21  200 ES  
BSDHacker       5c:d9:98:69:df:2e   11   54M -15:-27  100 EP   HTCAP WPA WME WPS
</pre>
If not, create a new wlan device (replace run0 by your drivers; like rtwn0 or urtwn0 ). 
: <code>sudo ifconfig wlan0 create wlandev run0</code> 
If not <code>sudo ifconfig wlan0 up scan</code> should do it. Now you can setup your network. From above you have non-encrypted and encrypted Wi-Fi networks listed.  WLAN_6EFI is non-encrypted access point.    rogerwifi and BSDHacker are encrypted access points.

<!--T:78-->
For a non-encrypted Wi-Fi network add the following lines to the file ''/etc/wpa_supplicant.conf''.
<pre>
network={
        ssid="WLAN_6EF1"
        bssid=00:13:f7:c4:6e:f3
        key_mgmt=NONE
}
</pre>
For an encrypted Wi-Fi network add the following lines to the file ''/etc/wpa_supplicant.conf''.
<pre>
network={
        ssid="BSDHacking"
        bssid=5c:d9:98:69:df:2e
        key_mgmt=WPA-PSK
        proto=WPA
        psk="yourpasword"
}
</pre>

After editing the /etc/wpa_supplicant.conf file, execute the wpa_supplicant command and the dhclient command.
<pre>
killall dhclient
wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf 
dhclient wlan0
</pre>

For more completed documentation see [http://www.freebsd.org/doc/handbook/network-wireless.html Wireless Networking].

<!--T:79-->
If <code>sudo ifconfig wlan0 up scan</code> still not scanning, then please complete a [http://issues.ghostbsd.org/ problem report form]. Your report will help to improve GhostBSD.

== '''Hardware''' == <!--T:80-->

=== Does GhostBSD support the [[wikipedia:en:3D acceleration|3D acceleration]] of my graphics card? === <!--T:81-->

<!--T:82-->
It depends on the hardware of your graphics card, to have support by GhostBSD (or not).<ref>[https://www.freebsd.org/doc/handbook/x-config.html#idp63187920 FreeBSD Handbook: Xorg Configuration#Caveats]</ref>

<!--T:83-->
; ATI/Radeon:
: 3D acceleration will not work on [[wikipedia:en:ATI Technologies|ATI]] or [[wikipedia:en:Radeon|Radeon]] cards until FreeBSD completes its [[wikipedia:Translation Table Maps|TTM]]<ref>[https://wiki.freebsd.org/Graphics#Kernel_drivers FreeBSD Wiki: Graphics#Kernel drivers]</ref> work (possibly in time for FreeBSD&nbsp;10.0)<ref>[https://wiki.freebsd.org/Ports/X11/Roadmap FreeBSD Wiki: Ports/X11/Roadmap]</ref>. You can still use these cards, but you will have to choose the 2D driver, and if that does not work, you will need to resort to using the Vesa driver.
; Intel:
: GhostBSD supports 3D acceleration on most Intel graphics cards. Due to the current [[wikipedia:en:kernel mode-setting|KMS]] support<sup>[https://wiki.freebsd.org/Intel_GPU]</sup>, you will not be able to switch between the graphical console and a virtual console (using <tt>[[wikipedia:en:Ctrl key|Crtl]]</tt>+<tt>[[wikipedia:en:Alt key|Alt]]</tt>+<tt>[[wikipedia:en:Function key|F#]]</tt>) when using the "sc" console driver.
: Switching between graphics and text consoles will work when using the "vt" console driver, and GhostBSD right now default to "vt" console.
; Nvidia Graphics:
: Yes! But [https://svnweb.freebsd.org/ports/head/x11/nvidia-driver/ nvidia-driver] must be loaded.<sup>[https://www.freebsd.org/doc/en/articles/compiz-fusion/nvidia-setup.html]</sup> The software can be installed easily, for example by using the (bxPKG/pkg) [[Package Manager]] or using ports as described on this page [[Nvidia driver installation]].

== References == <!--T:84-->
<references/>
</translate>