Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Jérome Perrin
gitlab-ce
Commits
bca03d08
Commit
bca03d08
authored
Jul 01, 2016
by
Stan Hu
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add troubleshooting section for SMTP settings
[ci skip]
parent
3041c433
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
51 additions
and
2 deletions
+51
-2
doc/administration/troubleshooting/debug.md
doc/administration/troubleshooting/debug.md
+51
-2
No files found.
doc/administration/troubleshooting/debug.md
View file @
bca03d08
...
@@ -3,9 +3,58 @@
...
@@ -3,9 +3,58 @@
Sometimes things don't work the way they should. Here are some tips on debugging issues out
Sometimes things don't work the way they should. Here are some tips on debugging issues out
in production.
in production.
##
The GNU Project Debugger (gdb)
##
Mail not working
`gdb`
is a must-have tool for debugging issues. To install on Ubuntu/Debian:
A common problem is that mails are not being sent for some reason. Suppose you configured
an SMTP server, but you're not seeing mail delivered. Here's how to check the settings:
1.
Run a Rails console:
```sh
sudo gitlab-rails console production
```
or for source installs:
```sh
bundle exec rails console production
```
2.
Look at the ActionMailer
`delivery_method`
to make sure it matches what you
intended. If you configured SMTP, it should say
`:smtp`
. If you're using
Sendmail, it should say
`:sendmail`
:
```ruby
irb(main):001:0> ActionMailer::Base.delivery_method
=> :smtp
```
3.
If you're using SMTP, check the mail settings:
```ruby
irb(main):002:0> ActionMailer::Base.smtp_settings
=> {:address=>"localhost", :port=>25, :domain=>"localhost.localdomain", :user_name=>nil, :password=>nil, :authentication=>nil, :enable_starttls_auto=>true}```
```
In the example above, the SMTP server is configured for the local machine. If this is intended, you may need to check your local mail
logs (e.g. `/var/log/mail.log`) for more details.
4.
Send a test message via the console.
```ruby
irb(main):003:0> Notify.test_email('youremail@email.com', 'Hello World', 'This is a test message').deliver_now
```
If you do not receive an e-mail and/or see an error message, then check
your mail server settings.
## Advanced Issues
For more advanced issues,
`gdb`
is a must-have tool for debugging issues.
### The GNU Project Debugger (gdb)
To install on Ubuntu/Debian:
```
```
sudo apt-get install gdb
sudo apt-get install gdb
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment