Skip to content
This repository was archived by the owner on May 12, 2018. It is now read-only.

IRC channel Guidelines and F.A.Q.

Jump to bottom
Sam Gleske edited this page Feb 3, 2014 · 48 revisions

First and foremost is the #gitlab channel on freenode motto.

Have a question? Don't ask to ask! Just ask, and wait to see if anyone answers.

That being said please review How To Ask Questions The Smart Way by Eric S. Raymond. Our IRC community is open, friendly, and helpful. This community is not operated by GitLab staff but by users of GitLab just like you. Some guidelines follow.

  • We treat each other with respect as peers and ask you to do the same.
  • Some members hang out in this channel 24x7 which means there can be significant delays (usually no more than 24 hours) before you see an answer to your question. If that is the case please be patient and come back to your chat client later.
  • When sharing logs or version information about your installation be sure to use an online paste service and providing a link so other channel users can review your information. It is recommended that you edit your pastes to remove personal information.
  • If you have a registered nickname with freenode then we can use MemoServ to contact you if you log out before your issue can be addressed. Be aware that this will not always be the case. Hanging out in the channel will be your most reliable form of getting help.

Frequently Asked Questions

Have issues with the GitLab channel?

Contact one of the community managers who hang out in the channel: newton, dblessing, sag47.

My GitLab installation isn't working!

If you're having trouble visualizing the overall architecture of GitLab then see the GitLab Architectural Overview doc.

gitlabhq provides rake tasks with which you can provide users in the IRC channel with version information and run a quick check on your configuration to ensure it is configured properly within the application. See maintenance rake tasks. In a nutshell we ask that you do the following.

sudo -i -u git
cd gitlab
bundle exec rake gitlab:env:info RAILS_ENV=production
bundle exec rake gitlab:check RAILS_ENV=production

Make sure that all tasks in the check pass. If you have trouble then paste the output of gitlab:env:info and gitlab:check to a paste site and link us in the channel so we may look it over. It is recommended to remove any sensitive information from these tasks or logs that you post should you feel the need.

What are common locations for GitLab logs?

Note: ~git/ is shorthand for /home/git.

gitlabhq (includes unicorn and sidekiq logs)

  • ~git/gitlab/log/ contains application.log, production.log, sidekiq.log, unicorn.stdout.log, githost.log, satellites.log, and unicorn.stderr.log normally.

gitlab-shell

  • ~git/gitlab-shell/gitlab-shell.log

ssh

  • /var/log/auth.log auth log (on Ubuntu).
  • /var/log/secure auth log (on RHEL/CentOS).

nginx

  • /var/log/nginx/ contains error and access logs.

Apache httpd

  • Explanation of apache logs.
  • /var/log/apache2/ contains error and output logs (on Ubuntu).
  • /var/log/httpd/ contains error and output logs (on RHEL/CentOS).

redis

  • /var/log/redis/redis.log there are also logrotated logs there.

clone over ssh asks for git password

There's likely an issue with the permissions on ~git/.ssh/authorized_keys. See OpenSSH F.A.Q. 3.14. In a nutshell assuming you set up GitLab with default settings you should set/have the following permissions.

chmod go-w /home/git /home/git/.ssh
chmod 600 /home/git/.ssh/authorized_keys
chown git\: $HOME/.ssh/authorized_keys

You can test your GitLab ssh connection with the following commands and output.

$ ssh [email protected]
PTY allocation request failed on channel 0
Welcome to GitLab, Sample User!
Connection to gitlab.example.com closed.

If you get a Welcome to GitLab, Anonymous! message then it is likely because you manually modified authorized_keys for the git user. You should only add SSH keys through the GitLab web interface. In Ubuntu users have experienced the Welcome to GitLab, Anonymous! by having multiple versions of ruby installed. To check for multiple versions of ruby run the following one liner.

echo "$PATH" | tr ':' '\n' | sort -u | while read x;do [ -f "$x/ruby" ] && ( echo -n "$x/ruby - ";$x/ruby --version );done

It is recommended to attempt to remove versions other than what is intended.

Since you're on the topic of hacking SSH it is recommended to implement sag47's solution for denying passwords over SSH and giving users a friendly message as to what they did wrong.

This wiki is deprecated, use the docs portal instead https://docs.gitlab.com.

Clone this wiki locally