What to do if “WordPress can’t create an .htdocs file on my Mac”

One of the first things I wanted to do when I first got my MacBook was to install WordPress locally to use it as a development sandbox.

Even after following the tutorial at WP Candy I couldn’t get WordPress to work perfectly on the Mac. I uninstalled MAMP and tried using XAMPP, which I had used successfully on my PC. I had the same problem with both. First, you are not alone. (I was prompted to write this post when an EXPERIENCED developer friend had problems configuring WordPress properly on his brand new MacBook Air.)

After several futile Google searches and digging through the forums (http://wordpress.org/support/) I came up with this solution.


  • WordPress asks for an FTP password when trying to update a plugin. It wouldn’t take my login password, so I reverted to doing a manual update. It worked, but it’s not what we want.
    WordPress asks for FTP credentials
  • If you try to update your permalinks, WordPress chokes while trying tocreate an .htdocs file. It complains about not having permissions to write to the file:
    WordPress can't write to .htdocs file


Here is how I fixed the problem. I used the terminal to do this (I worked as a Unix Sysadmin for several years). (If there is enough feedback I might do a follow-up on doing it using the GUI an a mouse.)

1. Find the directory where the problem lives:

$ cd /Applications/XAMPP/xamppfiles


2. Check the permissions and ownership on the  htdocs folder:

$ ls -l

htdocs directory permissions

3. Find the username that your Mac knows you as. In my case it’s icet. I’ll use myuser for this example. Change the user and group of the folder. One command will do it; you will probably need to use sudo.

$ whoami
$ sudo chown -R myuser:staff htdocs

Change ownership of the htdocs directory

We’re getting closer but Apache still can’t write to the htdocs folder. We need to tell XAMPP to run Apache as someone else

5. Change to the directory where the configuration file lives:

$ cd /Applications/XAMPP/xamppfiles/etc/

6. Make a backup of the configuration file, then change permissions of the configuration file so you can edit it:

$ sudo cp httpd.conf httpd.conf.bak

$ sudo chmod 777 httpd.conf

7. Edit the User and Group lines in the httpd.conf file. I use vim because I’m already at the command line. The Mac’s built-in TextEdit application will work too.

$ sudo vi httpd.conf

7.1. Find the User and Group lines

# User/Group: The name (or #number) of the user/group to run httpd as.
# It is usually good practice to create a dedicated user and group for
# running httpd, as with most system services.
User daemon
Group daemon

7.2 and change them so it looks like this (replace icet with your username from step 3):

# User/Group: The name (or #number) of the user/group to run httpd as.
# It is usually good practice to create a dedicated user and group for
# running httpd, as with most system services.
# User daemon
# Group daemon
User myuser
Group staff

httpd.conf after the fix

8. Stop and restart XAMPP

That should do it. You have given Apache the ability to write into the WordPress directory. It has worked fine for me for months.

Don’t do this on a production server! It probably introduces several security holes. Find a qualified server expert.

Business on a Budget

It would be great fun to start this post with the phrase, “I’m often asked what tools I use as a web developer, so I decided to write a blog post to answer that.” It would also be an outright lie, so I won’t do that.

Tools have been on my mind the last couple days, largely because my laptop just died. Also, writing this post would be an effective way to get another entry in SolidSmack‘s HP EliteBook Giveaway (you can enter their contest until December 19th, 2010 so click the link). 🙂

I have seen that machine, and it is beautiful. With a suggested retail price of $4899 it’s a lot more money than most casual users could ever justify, but the cool factor is through the roof.

Since my focus is helping small businesses manage their websites, I will devote a few (dozen) lines of text to hardware requirements.

The Computer

Nearly any modern computer will do, as long as it has a decent (not dial-up) internet connection. If you can run Windows XP or later (and by later I mean Windows 7, not Vista) and run a decent web browser (Firefox, Chrome, Safari, even Opera, but please stop using Internet Explorer) you can manage your WordPress site. (I don’t have any experience with Macs so I can’t tell you how old one has to be before it’s too slow to be effective.)

Yes, a faster processor and more RAM will improve your Internet “experience” but the latest and greatest hardware isn’t critical unless you plan to edit a lot of photos, audio or video to support your website. If you have to buy one, a solid laptop will run you $500 to $600, but a $350 model will do the job. If you are on a really tight budget, a netbook will work, but they have other limitations.

Input Devices

If you are writing a lot of blog posts (and you should be if you intend to promote your business effectively), you will need to be able to enter information efficiently. That means typing and pointing and clicking.


I will be blunt: touchpads suck. (Indignant Mac users may rant in the comments section.) Yes, newer ones let you scroll, but click-and-drag and right-click actions are hard to perform. Sleeves and palms brush them and screw up your typing. You shouldn’t have to concentrate on the mechanics of performing actions, you should just be able to DO them.

If you are working with a laptop or netbook, you must get a real mouse.

Just order plain coffee instead of a latte for four visits  and spend the $10 on an optical mouse with retractable cord. It will pay for itself in under an hour (unless you value your time at the U.S. minimum wage from 1987, in which case you should figure about three hours).


If you must take the bargain basement route, keep in mind that a netbook keyboard is smaller than a standard keyboard. It will take a touch typist a while to adapt to the smaller key spacing. Unless you are extremely comfortable with your keyboard or you do 100% of your work in coffee shops, get a keyboard to keep at your workspace.

I have spent enough years at computers that I have become a keyboard snob. (Most laptop keyboards put the delete key in the wrong place). I keep a full-size keyboard in the car, and yes, I do carry it into the library with me. (I’m more concerned with productivity and less worried about looking like a dork.) You don’t need a fancy ergonomic keyboard with buttons to launch email, control speaker volume, or start the espresso maker. Any decent office supply store will have a basic keyboard for $12 to $15.

Spend that extra money on yourself. You’re worth it.

The Monitor

If you think of your computer like a kitchen for concocting blog posts, then the monitor is your counter space. Can you imagine trying to cook a full-blown Thanksgiving dinner in a kitchen where the only counter space is 18 inches between the stove and the refrigerator? It can be done, but it’s not easy and it isn’t fun.

I have friends who do amazing amounts of work on a netbook, but they struggle with it:

WordPress can work with 1024 x 768 resolution in most browsers, but it’s tough. The menus on the left take a lot of space, and the editing box for writing posts is eclipsed by the control boxes on the right. There are workarounds, but the effects can range from mild annoyance to near-defenestration.

Just as adding counter space to your kitchen makes it easier to do more, adding screen space makes it easier to manage your blog.

If I’m a keyboard snob, I’m a monitor elitist.

You might be tempted to jump on the first deal you find for an inexpensive flat-panel LCD monitor. Before you plunk down your plastic, I suggest you check an under-rated specification: vertical resolution. Why? These screen shots show what writing this post would look like on different displays.

Note: Some images were cropped slightly to make up for the Windows menu bar. Also, other browsers (this is another reason to STOP USING INTERNET EXPLORER) leave even less room for your page, even before adding extra bloatware like the Yahoo! or Google toolbars.

Although not quite evil, monitor manufacturers have been doing something not very nice to boost sales: they dumb down displays to make them look like they are good for DVD movies. Yes, movies do fit nicely on them, but they’re less than optimal for creating content.

The reality is that most new widescreen monitors make your display a lot wider, but not much taller. If you can afford it, get a monitor with more vertical resolution. You will spend less time scrolling and more time doing important things.


Your website and blog should work for you, not the other way around. If you don’t live on the computer or edit photos or video for a living, you shouldn’t spend a lot of money on a computer. Sure, toys like HP’s new EliteBook make me drool, but I don’t do high-end CAD these days. A few dollars spent sensibly can help your website work for you without breaking the bank.

First Impressions of TweetDeck for Chrome

TweetDeck and Chrome logosMany people are picky about how they interact with Twitter, and I’m plunked down firmly in the center of that camp.

My laptop (where my trusty TweetDeck desktop application is installed) died a couple days ago. I prefer a multi-column Twitter interface, so using the “New” Twitter web interface while I wait for my laptop to get fixed is not an option.

I’m generally not an early adopter, but this was a perfect excuse to try the new TweetDeck extension for Google’s Chrome browser.

My Experience

The installation was straightforward, with a couple of mouse clicks it was up and running. To launch the application, just open a new (empty) browser tab and click the TweetDeck icon. I was a bit surprised that it didn’t even prompt me for a userid or password. I suspect that it recognized my Twitter account because I sometimes use it to log in to other web services.

I didn’t try the Facebook integration, but informal research (OK, I read a tweet about it) indicates that it’s “tight.”

The Good

  • The general compose box functions well. It makes it very easy to update from multiple Twitter accounts.
  • The reply box is embedded in the column above the tweet I’m responding to. Nice touch.
  • Ability to drag columns to reorder is helpful, but this still needs some refinement.
  • The automatic link shortening (using j.mp) is quick and smooth.
  • Detailed profile information is helpful, but lacks the thread view capabilities.
  • It has the same familiar charcoal background with light text. I like this color scheme but it’s not for everyone.
  • The visual notification box is gone. This could be a pro or a con, depending on your preference. The desktop application gave you the ability to change its appearance, location on the screen, or just plain turn it off.

The Not-so Good

Like any new software, it isn’t perfect. I suspect it will get better over time.
  • There is no button to view a conversation thread. I use this ALL THE TIME on the desktop app. This #FAIL may force me to Hootsuite until my laptop is fixed. @ToddWaller did point out that you can see a thread history when you reply to a tweet, but sometimes I just want to lurk.
  • Sometimes the background and screen flash while I’m typing in a compose box. This is quite annoying.
  • I couldn’t find a way to pause or slow the main stream, even when I’m scrolled down. In the short time I used this, I clicked on the wrong link a few times as the target tweet slid out from under the cursor.
  • Where’s the filter? This is another feature I use often on the desktop application.
  • Audible notifications are gone. In the desktop application I set them tell me about new @-mentions and direct messages. Without the pop-up notification window, this is even more important.
  • Customization ability is non-existent. The desktop application allows a lot of configuration options, update speed, accounts, notifications, link shortening, and more.


I’m not shy about admitting that I like TweetDeck. Their first effort at browser integration is a solid start. I’m not ready to switch, but it shows a lot of promise.

Have you used it? Let me know what you think.

Theme Selection Resource

The people at WP Candy have put together a great tool for helping people find WordPress themes. ThemeFinder lets you do a quick visual search by color, layout, and price (free or paid). You simply select filters from the top of the screen and the tool highlights thumbnails that fit your criteria. Click any link to view a larger version of the them at the author’s site.

It’s not an inclusive list by any stretch, but I think they did a good job focusing on quality. They include work from several theme shops that I didn’t know about. It’s a fun tool, and it’s definitely worth a look.

Tungle: A Time Management Tool

Do you Tungle? I do!

Not as much as I would like, but that’s changing as my small business grows.

What is Tungle? It’s a great way to simplify scheduling meetings. Let me give you a few reasons why I use it. These are my response to the questions posed on Tungle’s blog.
Inspired by John Jantsch of Duct Tape Marketing’s post, 5 Questions You Should Ask Every Customer, we’d like to ask you these 5 questions:

1. What made you decide to start Tungling?

  • I saw someone Tweet about it one day and thought I would check it out. The quick video intro on the home page sold me.

2. What’s one thing we do better than any other productivity app out there?

  • I like the ease of seeing different people’s schedules vertically. I haven’t researched these in great detail, but I helped a client schedule a meeting with another online scheduling tool (I honestly forgot which one) that was less intuitive. I also think the name is memorable. It reminds me of a Jethro Tull song…

3. What’s one thing we could do to create a better experience for you?

  • It would be nice to be able to look up friends or business contacts via their email address. I’m not looking for a directory, I would just like to be able to enter the email address of someone I know and find their Tungle calendar.
  • While we’re at it, maybe we could go so far as to look up someone’s schedule based on a Twitter ID. I have people I know on Twitter who I don’t use email to work with.

4. Do you refer Tungle.me to others?  If yes, why?

  • Yes, I have recommended it to several people. A few of them have signed up with it, too. I really appreciate that your availability is well, available. My tungle.me link is both on my business card and in my email signature. Why isn’t yours? It makes it easy for someone to schedule a meeting.

5. What would you Google to find an app like Tungle.me?

  • I don’t know, I haven’t thought much about finding better productivity tools. If I did, I might look for “schedule meeting” or “calendar management.”

I’m still green enough as a solopreneur that I haven’t thought to look for tools to improve my productivity. That will change, though. I hope your small business grows even more quickly than mine does. If you Tungle, it might happen faster than mine is.

My new website will definitely have a Tungle link in the sidebar.

[disclaimer: I’m totally gunning for a free T-shirt and gift certificate. But I promise, I will never endorse anything here that I don’t have personal experience with.]